═══ 1. Copyright notice ═══ Copyright notice This software and documentation is copyrighted by Alexander Wilkens, iLogic Software This software is SHAREWARE and is provided as-is. The author will in no event be liable for loss of profits, nor incidental or consequential damages. You use this software at your own risk. This software may not be modified, disassembled or reverse engineered in any way, except by the author, Alexander Wilkens. DirMaster may be distributed in unmodified shareware form freely, provided no charge is made for it, with the exclusion of BBS service charges. Shareware vendors may NOT charge any fee for distributing this software. Users are entitled to use DirMaster free of charge for a trial period of thirty days. If the user wishes continue the use of DirMaster beyond this trial period, he/she must register. DirMaster may not be distributed in registered form by any means. This includes distribution of registration NAMES registration KEYS. Registration entitles the user rights to use DirMaster indefinitely. Registrations are non-transferable and non-redeemable. Check out the How to register chapter for information on how to register your copy of DirMaster. ═══ 2. How to contact the author ═══ How to contact the author Worldwide networks: Internet: alex@romeo.rlmk.no Fidonet: 2:212/8.13@fidonet.org SBCnet: 14:1600/100.13 In Norway: SkyNet: 47:400/101.13 VilleMo BBS # +47 77 747493 (Support/DirMaster conference) Mail: Alexander Wilkens / iLogic Software, Hansmarkveien 37, 9013 TromsЫ, Norway. ═══ 3. Distribution ═══ Distribution Select one of the following chapters: General distribution CD distribution ═══ 3.1. General distribution ═══ General distribution DirMaster may be distributed anywhere in unmodified form as long as the following conditions are followed:  You may not charge any fee for DirMaster, except to cover distribution costs.  It must be clear that DirMaster is not Freeware or Public Domain, but Shareware.  If you run a Shareware distribution company you must contact me before you start distribution.  DirMaster may not be bundled with any Microsoft or Creative Labs product. ═══ 3.2. CD distribution ═══ CD distribution DirMaster may be included on a Shareware CD-ROM on the one condidtion that I, the author, receive a free copy of the CD-ROM. I also appreciate being contacted on beforehand. If the CD-ROM is being released in new versions on a regular basis, you must send me a copy of each version of the CD-ROM that contains DirMaster. ═══ 4. Obtaining the latest version ═══ Obtaining the latest version The latest release version of DirMaster should always be availible from the following BBS' and FTP sites: Internet FTP: On hobbes.nmsu.edu in the /pub/os2/incoming directory. It will probably later be moved to /pub/os2/32bit/diskutils on both hobbes and ftp.cdrom.com. Norwegian BBSs: ProSoft BBS VilleMo BBS BigBlue BBS InfoLink BBS USA BBSs: BMT Micro (910) 350-8061 ═══ 5. Current members of iLogic Software ═══ Members of iLogic Software Alexander Wilkens: -OS/2 C programmer Stian Andorsen: -OS/2 C/C++ programmer -Graphician Vegar Wang: - DOS/OS2 Assembly programmer ═══ 6. Team DirMaster ═══ Team DirMaster ■ Alexander Wilkens, programmer and documentation writer. ■ Stian Andorsen, betatester. ■ Arne Coucheron, betatester. ■ NjЖl Borch, betatester. ■ Vegar Wang, betatester. ■ Vidar Eriksen, betatester. ■ Tore Bredeli Joergensen, betatester. ═══ 7. Keyboard reference ═══ Keyboard reference Space - toggles active dirwindow TAB - toggles active dirwindow Left arrow - scrolls active dirwindow left Right arrow - scrolls active dirwindow right Up arrow - scrolls active dirwindow up Down arrow - scrolls active dirwindow down PageUp - scrolls active dirwindow one page up PageDown - scrolls active dirwindow one page down Home - scrolls active dirwindow to the top End - scrolls active dirwindow to the bottom Enter - activates the path box below the active dirwindow. Another enter reads the directory specified in the path box Escape - Cancels fileoperations Insert - Makedir Delete - Delete + (plus) - Selectes all files in the active dirwindow - (minus) - Deselectes all files in the active dirwindow ═══ 8. Drag & drop ═══ Drag & drop DirMaster supports drag & drop both ways. That is you can drag both from DirMaster to any program and from a program to DirMaster. You can also drag files within DirMaster from one dirwindow to the other. You drag files by first selecting them and then pressing and holding the right mouse button down. When dragging files from one dirwindow to the other the following applies. The files are moved when you only hold the right mouse button down, and are copied when you press CTRL at the same time. Dragging files from DirMaster to another application and the other way around works the same way as the drag described above. DirMaster itself performs the copy/move when dragging to DirMaster, but not when dragging from DirMaster (now it is the other application's responsibility). DirMaster's drag'n'drop supports 4dos/4os2 file descriptions when dragging: -From one DirMaster window to the other. -When dragging files from another application/the desktop to DirMaster. ═══ 9. Commandline parameters ═══ Commandline parameters /dscroll Enables a scrollbar to the left of the drive buttons. This feature may not work properly on some systems, so if this causes DirMaster to crash when loading then do not use this switch. ═══ 10. Description support ═══ Description support DirMaster supports 4dos/4os2 style descript.ion files for file comments/descriptions. This includes adding/removing descriptions and copying/moving/deleting/renaming/cloning files. You can use the describe function to edit file descriptions. ═══ 11. Main window ═══ Main window Select one of the following chapters: Menus Statusline Label and freespace boxes Dirwindows Directory path boxes Arrow buttons Button panel ═══ 11.1. Menus ═══ Menus DirMaster: Configure... - Loads configuration notebook Exit... - Quits DirMaster. Exactly the same as the Quit button. Cmd lines: OS/2 Win - Starts an OS/2 windowed command prompt OS/2 Full - Starts an OS/2 fullscreen command prompt DOS Win - Starts an DOS windowed command prompt DOS Full - Starts an DOS fullscreen command prompt Dir sort: Ascending - Sort directory in ascending direction Descending - Sort directory in descending direction Unsorted - Keep directory unsorted Filename - Sort directory by filename in the selected direction Extension - Sort directory by extension in the selected direction Size - Sort directory by size in the selected direction Time - Sort directory by date and time in the selected direction Toggles: Show hidden - Show hidden files in the dirwindows Show system - Show system files in the dirwindows Show read-only - Show read-only files in the dirwindows Show desc. files - Show description files in the dirwindows Show EA data files - Show EA data files in the dirwindows Misc: View INF doc - Views this doc using VIEW.EXE View Readme file - Views Read.me using E.EXE View Revision file - Views DMaster.Rev using E.EXE View Registration form - Views World.Reg using E.EXE Register... - Brings up the registration dialog About... - Brings up the about dialog ═══ 11.2. Statusline ═══ Statusline The statusline is the raised 3D box directly below the menu. It has two purposes: 1. Displaying the number of selected files, dirs and their bytesize, and displaying the total number of files and dirs in the directory and their total filesize. The format is like this: # of selected dirs / total # of dirs # of selected files / total # of files selected bytes / total bytes 2. Displaying information that need no confirmation, like Operation complete! and also current action etc, when performing fileoperations on single files. It is generally used when the Progress dialog is not displayed. ═══ 11.3. Label and freespace boxes ═══ Label and freespace boxes Purposes: - Display disk label of the current drive - Display free diskspace on the current drive. - Show which directory window is selected. The box above the selected window is highlighted. Switching between directory windows: This can be acomplished in several ways. The easiest way is by clicking the right mouse button in the window you want selected. This also causes free diskspace and disklabel to be updated for this window. Another way is to use the left mouse button. This does NOT cause free diskspace or disklabel to be updated. It does however cause the file beneath the pointer to be selected. A third way is to use the keyboard. Both TAB and SPACE switches to the other dirwindow. Displaying the available drives list: By pressing both mouse button 1 and 2 simultaneously (chord) the active dirwindow will display a list of all drives available. Choosing a drive from this list causes the root directory of that drive to be loaded in the same dirwindow (replacing the drive list). ═══ 11.4. Dirwindows ═══ Dirwindows The directory (dir from now on) windows are two listboxes (my own, not the system's) containing files in the current dirs (you have two current dirs. A source and a target.). The selected dir automatically becomes the source and the other the target. Multiple files can be selected in the dir windows by either clicking on the files one by one, by draging the mouse up/down while holding mouse button #1 down or by pressing the All button or None button. Left mouse button double clicking: The dir windows support double clicking. DirMaster will take an action when any of the following are double clicked: - Directories. Double clicking on one will cause DirMaster to enter it and display it (replacing the current dir) in the dir window. This includes the parent directory (..) if it is enabled in the dirwindows configuration. - Files with the extension EXE or COM. DirMaster will try to figure out wheather it is a DOS, Windows, OS/2 textmode or PM program. You can then specify cmd line parameters in execute dialog that pops up. - Files with the extention CMD. DirMaster will load the default cmdline interpreter (CMD.EXE, 4os2.exe or whatever) and run the batch file. - Files with the extention BAT or BTM. The DOS cmdline interpreter will be loaded and the batch file run. - Files with extensions configured in the User button configuration. The corresponding user function will be executed. Other clicking: The dirwindows support some special clicks too. There are two ways to go to the parent directory without using the Parent button or doubleclicking on the parent directory (".."). The first one is by double clicking with the right mouse button inside the dirwindow. This feature is always enabled and cannot be disabled. The second method it to move the mouse pointer out to the outer edge of the dirwindow, that is the left side in the left window and right side in the right window, and press the left mouse button. This function can be disabled in the General 2 page in the configuration. The last quick mouse function in the dirwindow allows the user to quickly go to the root directory. It is performed by clicking the right mouse button on the outer window edge. This function can be disabled in the General 2 page in the configuration. Locating files quickly: To find a specific filename in the dirwindow, just type the character corresponding to the first character in the filename and DirMaster will scroll the dirwindow to the first file it located. If no file starting with that character, Dirmaster will increase the character by one until it finds a match. Note: This functions may not always work correctly in other sorting modes than ascending/filename. ═══ 11.5. Directory path boxes ═══ Directory path boxes Path boxes (see the picture below) are situated below the two dir windows. Their functions are to contain the path for the drive window above it. The boxes are automatically updated whenever a new directory is loaded. The path boxes can also be used to change directories. Just click inside it, enter the desired directory (including drive) and press enter. If you made a mistake in the directory name DirMaster will let you know by writing in the label box above the dir window. The directory path you had typed will still be in the path box so you won't have to type it all over again. ═══ 11.6. Arrow buttons ═══ Arrow buttons These three buttons does the following: The < button reads the directory contained in the right dirwindow into the left dirwindow. The directory in the right window remains the same. The > button does the opposite of the < button. It reads the directory contained in the left dirwindow into the right window. These two buttons can be useful if for instance you wish to copy a file in the current directory into a sub dir in the current directory. To do that you would just have to "copy" the dir with one of the two buttons mentioned above, then enter the sub dir and the file is ready to be copied. The <> swaps the two directories in the dirwindows. The left dir is moved to the right dirwindow and the right dir is moved to the left dirwindow. This has no practical use unless you prefer to have the target dir in, say, the right dirwindow. ═══ 11.7. Button panel ═══ Button panel The button panel consists of all the buttons at the bottom of the DirMaster window. They are divided into two types of buttons: Drive buttons Function buttons ═══ 11.7.1. Drive buttons ═══ Drive buttons The drive button row is positioned to the right on the button panel. Their function is to allow the user to quickly change between several dir and/or drives configured in the Drive buttons configuration. These buttons appear like normal buttons, but are in fact not quite normal. There are only a few buttons visible at at time. This number is the same as the number of rows selected for the button panel in the Button panel configuration. These buttons consists of several banks of buttons. Going to the next bank is acomplished by clicking the right mouse button anywhere on the buttons. The number of banks is dependent on which button is the last to contain a label in the Drive page configuration. The maximum number of banks is 5, and the maximum number of rows is 6. That gives a maximum of 30 drive buttons which ought to be enough for anyone. :) ═══ 11.7.2. Function buttons ═══ Function buttons The function buttons consists of two types of buttons. Internal functions are those supplied by DirMaster (Copy, Move, Rename etc.) and user functions specified and configured by the user in the User configuration. Just like the Drive buttons, these buttons behave a little different from ordinary buttons. They can each contain two functions. Double click here to get explanation. The buttons who has a small peel-off paper in the upper right corner have a right mouse button function. You can also have multiple banks of buttons. This is configured in the Button panel configuration. To switch bank (assuming you have more than one bank) press the left or right mouse button on the bottom statusline. The left mouse button changes to the previous bank while the right mouse button moves to the next bank. The following internal function are available: All Archive Archive (Background) Archive list Attribute Copy Copy as Clone CreateObject Delete Describe Dir size Makedir MultiAttribute Move Move as None Parent Print PrintDir Quit Relabel Rename Reread Root Search Toggle Unarchive Unarchive (background) Wildcard deselect Wildcard rename Wildcard select ═══ Copy ═══ Function: Copy file(s) and/or dir(s). Query on overwrite. Requires: Selected file(s) and/or dir(s) in source dir, target dir. Notes: Errors are displayed by DirMaster's own error dialog. Can be aborted by pressing ESC or the cancel button in the progress dialog. ═══ Copy as ═══ Function: Copy file(s) and/or dir(s) to target dir with a new name. A dialog will pop up for each file/dir asking for the new name. Skip and cancel buttons are available. DirMaster will query on overwrite. Requires: Selected file(s) and/or dir(s) in source dir, target dir. Notes: Errors are displayed in DirMaster's own error dialog. Can be aborted by pressing ESC or the cancel button in the progress dialog. ═══ Move ═══ Function: Move file(s) and/or dir(s). Query on overwrite. Requires: Selected file(s) and/or dir(s) in source dir, target dir. Notes: Errors are displayed in DirMaster's own error dialog. Can be aborted by pressing ESC or the cancel button in the progress dialog. ═══ Move as ═══ Function: Move file(s) and/or dir(s) to target dir with a new name. A dialog will pop up for each file/dir asking for the new name. Skip and cancel buttons are available. DirMaster will query on overwrite. Requires: Selected file(s) and/or dir(s) in source dir, target dir. Notes: Errors are displayed in DirMaster's own error dialog. Can be aborted by pressing ESC or the cancel button in the progress dialog. ═══ Delete ═══ Function: Deletes file(s) and/or dir(s). A Delete Warning will be displayed if it was enabled for the current situation in the General 1 page int the configuration. Requires: Selected file(s) and/or dir(s) in source dir. Notes: Errors are displayed in DirMaster's own error dialog. Can be aborted by pressing ESC or the cancel button in the progress dialog. ═══ Clone ═══ Function: Clone selected file(s) and/or dir(s). Operates like Copy as, except that the source dir is also the target dir. Requires: Selected file(s) in source dir. Notes: Errors are displayed in DirMaster's own error dialog. Can be aborted by pressing ESC. ═══ Archive ═══ Function: Archive files. Pops up a dialog asking for a name for the archive and what archiver to use (ZIP, ARJ, LHA, ZOO or ARC). The archive is put in the target dir. Requires: Selected file(s) and/or dir(s) in source dir, target dir. Notes: Errors are displayed in the statusline. The archiver is executed in the foreground while DirMaster waits. The waiting can be aborted by pressing ESC or the cancel button in the progress dialog. ═══ Archive (background) ═══ Function: Archive files in the background. Pops up a dialog asking for a name for the archive and what archiver to use (ZIP, ARJ, LHA, ZOO or ARC). The archive is put in the target dir. Requires: Selected file(s) and/or dir(s) in source dir, target dir. Notes: Errors are displayed in the statusline. The archiver is executed in the background. ═══ Unarchive ═══ Function: Unarchive files. Determines the archive type by looking at the first bytes in the archive and then executes the correct unarchiver. Requires: Selected file(s) in source dir, target dir. Notes: Errors are displayed in the statusline. DirMaster waits till the archiver is done. The waiting can be aborted by pressing ESC or the cancel button in the progress dialog. ═══ Unarchive (background) ═══ Function: Unarchive files. Determines the archive type by looking at the first bytes in the archive and then executes the correct unarchiver. Requires: Selected file(s) in source dir, target dir. Notes: Errors are displayed in the statusline. The unarchiver is executed in the background. ═══ Achive List ═══ Function: View contents of archives. Determines the archive type by looking at the first bytes in the archiven, executes the correct archiver with the list switch and views the list of files with the configured lister. Requires: Selected file(s) in source dir. Notes: Errors are displayed in the statusline. DirMaster waits while the archive lister is executed. The waiting can be aborted by pressing ESC or the cancel button in the progress dialog. ═══ Parent ═══ Function: Changes to the parent directory in the selected dir window. If the current dir is root no action is taken. Requires: Source dir. Notes: Errors are displayed in the statusline. ═══ Select All ═══ Function: Selects all files and dirs in the selected dir window. Requires: Source dir. Notes: No errors. ═══ Toggle ═══ Function: Toggles selected and unselected items in the dirwindow. Selected items become unselected and visa versa. Requires: Source dir. Notes: No errors. ═══ Select None ═══ Function: Deselects all files and dirs in the selected dir window. Requires: Source dir. Notes: No errors. ═══ Root ═══ Function: Changes to the root directory in the selected dir window. If the current dir is root no action is taken. Requires: Source dir. Notes: Errors are displayed in the statusline. ═══ Reread ═══ Function: Rereads the directory in the selected dir window. Useful when an external program has changed the contents of the directory. Requires: Source dir. Notes: Errors are displayed in the statusline. ═══ Makedir ═══ Function: Create a directory in the selected dir window. Requires: Source dir. Notes: Errors are displayed in the statusline. ═══ Attribute ═══ Function: Pops up the attribute dialog to allow the user to change the file attributes for each of the selected files. Requires: Selected file(s) in the source dir. Notes: Errors are displayed in the statusline. ═══ MultiAttribute ═══ Function: Pops up the attribute dialog to allow the user to set the same file attributes for all the selected files. Requires: Selected file(s) in the source dir. Notes: Errors are displayed in the statusline. ═══ Rename ═══ Function: Rename the selected files and dirs in the selected dir window. Pops up a dialog where the user can specify a new name. Requires: Selected file(s) and/or dir(s) in the source dir. Notes: Errors are displayed in DirMaster's own error dialog. ═══ Relabel ═══ Function: Changes the label on the disk in the selected dir window. Disk labels may only be 11 characters long. Requires: Source dir. Notes: Errors are displayed in DirMaster's own error dialog. ═══ Quit ═══ Function: Quits DirMaster. Requires: Nothing. Notes: No errors. ═══ Wildcard select ═══ Function: Selects file(s) in the dir window by wildcard selection. Enter a wildcard pattern in the dialog (ex: "*.zip"). Requires: Sourcedir. Notes: No errors. ═══ Wildcard deselect ═══ Function: Deselects file(s) in the dir window by wildcard selection. Enter a wildcard pattern in the dialog (ex: "*.zip"). Requires: Sourcedir. Notes: No errors. ═══ Wildcard rename ═══ Function: Rename the file(s) that match a specified wildcard pattern to a new wildcard pattern. (ex: "*.zip" => "*.arj") Requires: Source dir. Notes: No errors. ═══ Dir size ═══ Function: This function calculates the size of one or more directories and writes the size in the dirwindow (at the size position). The size of a directory is caculated by adding the size of all the files in the subdirectories of that directory. This functions also checks to see if the selected files/directories will fit on the target drive or not by displaying a YES or NO in the statusline. Requires: Selected dir(s) in the sourcedir. Notes: No errors. Can be aborted by pressing ESC. ═══ Print ═══ Function: This function prints the selected files as pure text. It pops up a dialog that lets you specify the printer device and the specific settings for that printerdriver. Requires: Selected file(s) in the source dir. Notes: Errors are displayed in the statusline. ═══ PrintDir ═══ Function: PrintDir allows the user to print the active directory to either the printer or a text file. The user selectes this in the PrintDir dialog. Requires: Source dir. Notes: Errors are displayed in the statusline. ═══ CreateObject ═══ Function: CreateObject, as the name suggests, creates an object on the desktop for each of the selected files. It does not process directories, nor does it let the user specify the name of each object as this can easily be accomplished by ALT+LeftMouseButton clicking on the objects. Requires: Selected file(s) in the source dir. Notes: Errors are displayed in the statusline. Can be aborted by pressing ESC or the cancel button in the progress dialog. ═══ Search ═══ Function: This function lets the user search for a file with a specific name (wildcards accepted) or containing a text string. The user is presented with the search dialog where he or she can choose between several options. The selected files and directories are the searched for files that matches the search criteria. The matching files are loaded with full path in a Results container in the target dirwindow, and can be manipulated by almost all of DirMaster's internal and user functions just as if the files were all in the same directory. Requires: Selected file(s) in the source dir. Notes: Errors are displayed in the statusline. Can be aborted by pressing ESC or the cancel button in the progress dialog. ═══ Describe ═══ Function: Changes the 4dos/4os2 description for the selected files. Requires: Selected file(s) and/or dir(s) in the source dir. Notes: Errors are displayed in the statusline. ═══ Two buttons on each button ═══ Just like the drive buttons, these buttons respond to the right mouse button. In a little different way, though. Each button can have one or two functions. The primary function (the one you can se written on the button) is always activated by pressing the left mouse button on it. The second function (where available) is activated by pressing the right mouse button on it. To see its label, hold the right mouse button down. If you decide that you don't want to 'press' it move the mouse pointer away from the button (you will see the button become raised again) and release the mouse button. If you want to press it release the mouse button with the pointer above the button you pressed. ═══ 12. Configuration ═══ Configuration The configuration of DirMaster is done in a notebok in the configuration dialog. The four buttons in the dialog have the following functions: Save: Saves the new configuration to DMaster.INI. This file is automatically loaded at startup. Use: Uses the new configuration, but does not save it do disk. Load: Loads configuration from DMaster.INI on disk. Cancel: Cancels any changes you have made to the configuration, and uses the same configuration as before. The following configuration notebook pages are availible: General 1 General 2 Archivers Button panel Drive buttons Function buttons User functions Fonts and colors Statusline Dirwindows 1 Dirwindows 2 ═══ 12.1. General 1 ═══ General 1 Delete warning: The configuration of delete warning gives you the control over the warnings DirMaster may, or may not display when you press delete. You can use any combination you want. Single file - Warn the user when a single or multiple file delete is about to occur. Single directory - Warn the user when a single or multiple dir delete is about to occur. Multiple files - Warn the user when multiple files are about to be deleted. Multiple directories - Warn the user when multiple directories are about to be deleted. Temporary directory: This box allows you to specify a directory where DirMaster can store its temporary files. They will be deleted automatically when DirMaster quits. The default here is "c:\". Freespace display options: This lets you configure how DirMaster will display the amount of free disk space on the current disk(s). The "Use denomination" specifies whether to write Kb/b/Mb or not after the free space. The radio buttons lets you choose whether to display in bytes, kilobytes or megabytes. Autoread: Specifies which two (if any) directories to automatically read at startup. Check the appropriate checkbox to the right of the appropriate editbox to enable it and write a path of your chice in the editbox. ═══ 12.2. General 2 ═══ General 2 Startup options: These settings give you control over how DirMaster is to appear when started. Start maximized: DirMaster is maximized when started. You will notice that the window will first appear in the same position and size as when you last quit DirMaster, before it sizes itself up to max size. Start normalized: DirMaster is started in normal (restored) size when started. You will also here notice that the window will first appear in the same position and size as when you last quit DirMaster, before it restores itself. Start minimized: DirMaster is started minimized. You will also here notice that the window will first appear in the same position and size as when you last quit DirMaster, before it minimizes itself. Start in previous position: DirMaster appears in the same position and size as when you last quit DirMaster. This was previously the default (and only) choice. Time display options: This section allows you to choose whether to use the clock or not in the bottom statusline and specify the displayed time format. You can use plain text in addition to the tokens explained below: Specifier Meaning %a Insert abbreviated weekday name of locale. %A Insert full weekday name of locale. %b Insert abbreviated month name of locale. %B Insert full month name of locale. %c Insert date and time of locale. %d Insert day of the month (01-31). %H Insert hour (24-hour clock) as a decimal number (00-23). %I Insert hour (12-hour clock) as a decimal number (01-12). %j Insert day of the year (001-366). %m Insert month (01-12). %M Insert minute (00-59). %p Insert equivalent of either AM or PM of locale. %S Insert second (00-61). %U Insert week number of the year (00-53) where Sunday is the first day of the week. %w Insert weekday (0-6) where Sunday is 0. %W Insert week number of the year (00-53) where Monday is the first day of the week. %x Insert date representation of locale. %X Insert time representation of locale. %y Insert year without the century (00-99). %Y Insert year. %Z Insert name of time zone, or no characters if time zone is not available. %% Insert %. Memory- and Swap-display options: You can enable and disable the displaying of free memory and total swapfile size in the bottom statusline. ═══ 12.3. Archivers ═══ Archivers This configuration dialog lets you configure the 7 archivers (ZIP, ARJ, LHA, ZOO and ARC, UC2 and ZipStream). DirMaster does not have the archivers built in, rather it uses external commandline programs. A default setup will be created the first time you run DirMaster, so all you have to do then is to make sure the paths are correct. You choose the archiver to configure from the listbox. Name: Lets you specify the name of the archiver. Not much used by DirMaster yet. Ident: Specifies the archive identification code that can usually be found in the first characters in the archive. This is in hex format. The spinbutton next to it specifies the offset at which the identification code can be found. You are advised NOT to change this unless you know what you are doing! Archive Cmd: The path and filename of the archiver. The BROWSE button brings up the system's filerequester. Archive Switches: Specify switches for the archiver. Extract Cmd: The path and filename of the unarchiver. The BROWSE button brings up the system's filerequester. Extract Switches: Specify switches for the unarchiver. List Cmd: The path and filename of the archiver lister/viewer. The BROWSE button brings up the system's filerequester. List Switches: Specify switches for the archive lister/viewer. ═══ 12.4. Button panel ═══ Button panel This page allows you to set up the number of rows, columns and banks in the button panel. The number of buttons and banks with the current configuration are also displayed. ═══ 12.5. Drive buttons ═══ Drive buttons This is where you set up the Drive buttons. Select the button to edit by clicking on it. The buttons are aligned like this: The leftmost column is page 1, the next page 2 etc. The number of rows is the same as the number selected in the Button panel configuration page. Foreground and background colors can be applied by using the color buttons. Colors are applied individually to each button for greater flexibility. The label of the drive button is entered in the textbox marked Name and can be up to 19 characters long. The drive and path for the button is entered in the Path editbox and must be a valid directory path. A trailing backslash is not neccessary. The path can be up to 259 characters long. The Shortcut key editbox is where you can enter a shortcut or hotkey for the button. The format is like this: Modifier+Key where the modifier can be either Alt, Control or Shift, or a combination of these (+ signs connecting them). The key can be from A to Z. This field is not case sensitive. Buttons: Copy bank: This button copies the contents of one bank to another bank. Everything is copied, and the source bank is not deleted. To perform do the following: Press the button, select a button (does not matter which) in the source bank, the select a button in the target bank. Swap bank: This button swaps the contents of one bank with another bank. This function is performed the same way as the previous. Delete bank: This button deletes the contents of one bank. Be aware that there is no undo function! To perform push the button and select the bank to be deleted. Sort bank: This button sorts a bank alphabetically in ascending order. To use simply follow the instructions for the delete button. Copy button: This button copies the contents of a single button to another button. The whole button is copied (its contents, that is) and the source is not deleted. To perform do the following: Press the button, select the source button then select the target button. Swap button: This button swaps the contents of one button with another button. This function is performed the same way as the previous. Delete button: This button deletes the contents of one button. Be aware that there is no undo function! To perform push the Delete button and select a button to be deleted. Get drives: This button querys the system for availible drives and assigns them to the drive buttons, starting in the upper left corner. For harddrives the volume label is used for button label. ═══ 12.6. Function buttons ═══ Function buttons This is where you set up the Function buttons. Select the button to edit by clicking on it. The buttons are aligned the same way as in the main window. The number of rows, columns and banks are the same as the numbers selected in the Button panel configuration page. Each button can have a right mouse button function as explained in the Function buttons part of the doc. You can switch between configuring the left and right mouse button function by using the Right mouse button and the Left mouse button radio buttons. To change bank use the buttons Prev bank and Next bank. Foreground and background colors can be applied by using the color buttons. Colors are applied individually to each button for greater flexibility. For each button you can select either Internal function, User function or None. When selecting Internal function you can choose between 31 internal functions. User function allows you to select a function configured in the User function configuration page. Selecting None leaves the button blank and empty. The Shortcut key editbox is where you can enter a shortcut or hotkey for the button. The format is like this: Modifier+Key where the modifier can be either Alt, Control or Shift, or a combination of these (+ signs connecting them). The key can be from A to Z. This field is not case sensitive. Buttons: Copy bank: This button copies the contents of one whole bank to another bank. Everything is copied, and the source bank is not deleted. The function will prompt you for the number of the target bank. The number of the current bank is displayed in the lower left corner. Swap bank: This button swaps the contents of one bank with another bank. This function is performed the same way as the previous. Clear bank: This button deletes the contents of one bank. Be aware that there is no undo function! Copy button: This button copies the contents of a single button to another button. The whole button is copied (its contents, that is) and the source is not deleted. To perform do the following: Press the button, select the source button then select the target button. Swap button: This button swaps the contents of one button with another button. This function is performed the same way as the previous. Clear button: This button deletes the contents of one button. Be aware that there is no undo function! To perform push the Delete button and select a button to be deleted. ═══ 12.7. User functions ═══ User functions The user function feature allows the user to define up to 9999 user functions in addition to DirMaster's own internal functions. These user buttons can be placed together with the internal buttons on DirMaster's button panel to do whatever taks the user wants with the use of external programs. You have a range of different options. Select a function from the list, or add a new on by pressing "Add". "Delete" removes a function and "Rename" renames a function. Label: This box contains the name of the selected user function. Command line: This is where you enter the command line to the button. You can use any of the tokens described below anywhere in the commandline, but the commandline MUST start with an executable file or a cmd.exe/4os2.exe internal command. The browse button brings up the system's filerequester. Tokens: %f = selected file(s). If the All files on same cmd line is checked all selected files are inserted here (as long as there is room on the cmd line). If not then only one selected file is inserted and the others will be processed one by one. %F = same as above except that it includes full path. %s = Inserts the source directory including trailing "\". %t = Inserts the target directory including trailing "\". %q"" = Displays a question dialog asking the question you put between the quotes. The dialog contains an edit box where the user can type in argument. %r"" = Displays the system's filerequester. Put the path and wildcards in the quotes. Extensions: Specify double clicking extensions here. The format is like this. Write ONLY the extensions (no '.') and seperate each extension with a comma. (Ex. "me,doc,txt" (don't include the quotes!)) Checkboxes: Requires selection: This option specifies that file(s) must be selected for the function to execute. If not checked then DirMaster ignores any selected files and the function will only be executed once no matter how many files were selected. CD to target: The function is executed from the target directory. All files on same cmd line: The function is executed only once with all selected files on the same command line (%f or %F token). Start CMD.EXE: The system's commandline processor is executed with "/C" + command line as the argument. Use this when running internal commandline processor comands. Run async on multi: The program is run asyncronously if multiple files were selected in the dir window. This causes DirMaster to execute the function with one selected file at a time waiting until the previous one terminated before executing the next. Useful when viewing pictures or when you want to reread a dir after program completion. Run async on single: The program is run asyncronously if only one file was selected. Fullscreen: The command line is executed in a fullscreen session if possible. To front: The command line is executed in the foreground if possible. Requires source dir: The function will not execute if there is no source dir present. Requires target dir: The function will not execute if there is no target dir present. Reread source directory: Rereads source dir after command line is executed. Should be used in conjunction with Run async... Reread target directory: Rereads target dir after command line is executed. Should be used in conjunction with Run async... ═══ 12.8. Font and color ═══ Font and color Some of the fonts DirMaster uses can be configured by the user. The listbox presents a list containing these. To configure one, select one from the box, select a foreground and background color of your choice by spinning the spin controls. The font can be changed by pressing the "Font" button. ═══ 12.9. Statusline ═══ Statusline Enable selection display: When enabled DirMaster will display selection information (how many files, dirs bytes etc.) in the statusline. Note: Informational messages will always be displayed in the statusline regardless of this setting. Number display: Fill with leading zeros: Leading zeros will be prefixed at all number displays to ensure a constant number width. This option is disbled if a thousand separator is used. Fill with leading spaces: Same as above except it will use spaces instead of zeros. Don't fill: No numbers will be prefixed with anything. Thousand separator: Use country default: The default configured in the OS/2 system setup will be used as thousand separator. Use..: Allows you to use whatever character you choose. Enter the character in the editbox to the right. Use space: Thousands are separated by a single space. No separator: Disables usage of thousand separator character. Enables the Fill with leading zeros choice above. General appearance: Add one space between slashes and numbers: Every slash ("/") and number is separated by a space. This makes the line look less crowded. Center statusline text: If checked the text will be centered, if not it will be left justified. This option does not take effect before you restart DirMaster. ═══ 12.10. Dirwindows 1 ═══ Dirwindows 1 Use ".." dir entry: When enabled DirMaster will include the parent directory entry at the top of the directory. The parent entry is never sorted and will always appear as the first entry. It is not present in the root directory. Sort direction: Ascending: Files will be sorted in ascending order, the smallest/first file first etc.. Descending: Files will be sorted in descending order, the biggest/last file first etc.. Unsorted: Files will not be sorted, but displayed in the same order that the filesystem has arranged them. Sort by: Filename: Files are sorted by filename. Directories are grouped together. Extension: Files are sorted by extention. The extention of a file name is determined by locating the last period character. Only the first 20 characters after the period is used by DirMaster as extension. Directories are grouped together. Size: Files are sorted by size. Directories are grouped together. Time/date: Files are sorted primarily by date and secondarily by time. Directories are not neccessarily grouped together. Right justify: Filesize: The filesize column is aligned with the right dirwindow border if possible. Attributes: The attributes column is aligned with the right dirwindow border if possible. Date: The date column is aligned with the right dirwindow border if possible. Time: The time column is aligned with the right dirwindow border if possible. None: Only the filename column is displayed, the user must scroll to see any of the other columns. Note: DirMaster may temporarily modify this setting on-the-fly if neccessary. Thousand separator: Use country default: The default configured in the OS/2 system setup will be used as thousand separator. Use..: Allows you to use whatever character you choose. Use space: Thousands are separated by a space. No separator: Disables usage of thousand separator character. Enables the Fill with leading zeros choice above. ═══ 12.11. Dirwindows 2 ═══ Dirwindows 2 Default display filter: These settings allows you to choose whether DirMaster should display files with special attributes or files that have a specific meaning to the OS. Show system files: Check to allow DirMaster to show system files. Show hidden files: Check to allow DirMaster to show hidden files. Show read-only files: Check to allow DirMaster to show read-only files. Show EA data files: Check to allow DirMaster to show EA data files. Show description files: Check to allow DirMaster to show description files. Desc. file: This editbox allows you to specify the filename of the description files to be used. Dirwindow general options: These settings give you additional control over the appearance and behavior of the two dirwindows DirMaster's mainwindow. Place scrollbar on left hand side in right dirwindow: This causes both of the scrollbar to be in the middle of the DirMaster window. (like in DOpus) Try it! Update dirwindow contents while loading directory: When this is enabled, DirMaster will draw the entries one at a time while loading a directory (like 1.x versions). When disabled DirMaster will not draw the entries until the whole dir is read. It will however update the scrollbar. Update dirwindow contents while deleting files: When checked causes DirMaster to update the dirwindow after each file and directory has been deleted in a delete operation. This can be slow on some systems, depending on the speed of your graphics card. When disabled Dirmaster does a redraw when all items have been deleted. Smooth entry-by-entry scrolling: This options enable you to enable/disable the smooth entry-by-entry scrolling in the dirwindows. This scrollmethod scrolls only one item at a time no matter how fast you drag the scrollbar. Only when a certain amount of entries behind does it jump. The number of entries behind before it jumps can be entered in the editbox. The faster graphics card you have the higher number you can specify. Enable parent and root on dirwindow outer edge: This checkbox enables or disables the quick parent and root function described in the dirwindows part of the doc. Dirwindow detail: Filesize: Show filesizes in the dirwindows. File attributes: Show file attributes in the dirwindows. File date: Show file dates in the dirwindows. File time: Show file times in the dirwindows. File description: Show file descriptions in the dirwindows. ═══ 13. Dialog windows ═══ Dialog windows Select one of the following chapters: Attribute / MultiAttribute Copy as / move as Execute Makedir PrintDir Rename Describe Relabel Search ═══ 13.1. Attribute / MultiAttribute ═══ Attribute / MultiAttribute This dialog lets you change the attributes as well as date/time of one or many files. The dialog can be in either Attribute mode or MultiAttribute mode. Attribute mode: The contains 4 checkboxes where you can enable and disable file attributes and 3 date/time buttons. Pressing any of these brings up a dialog which lets you change the time and date of the file. This can be either last read, last write or creation time/date depending on which of the 3 buttons you pressed. MultiAttribute mode: MultiAttribute mode is a bit more complicated. This mode affects not only on file, but all of the files selected. This mode contains 4 additional checkbuttons at the top where you can select what you want to change. For instance if you only want to set all the creation times/dates for the selected files to the same time and date, you would check only the Modify Creation times/dates checkbox and all the other attribues and times/dates would be left untouched. ═══ 13.2. Copy as / move as ═══ Copy as / move as Copies or moves a file to a file with a new name. Current filename in the depressed box. New filename in the edit box. ═══ 13.3. Execute ═══ Execute Provides the user a range of options when executing a program. File editbox: This editbox contains the name of the file to be executed. Args editbox: This is where you enter commandline arguments. You can use the Browse button to bring up the system's default filerequester. The filename will be inserted in the argument line. Radio buttons: The radio buttons specify programtype. DirMaster will try to guess the the programtype on beforehand, but may not always succeed. Especially at Windows apps. Checkboxes: Enhanced mode: Toggles enhanced mode on/off for Windows applications. Child application: Specifies that the program is to be executed as a child app. To front: Runs program in the foreground. ═══ 13.4. Makedir ═══ Makedir This dialog lets the user enter the name of the directory to be created. The user will be informed if illegal characters are used, or the directoryname lenght exceeds the filesystem's limit. ═══ 13.5. PrintDir ═══ PrintDir The PrintDir dialog allows the user to select which parts of the directory information to be printed through the 5 checkboxes in the top half of the dialog. In the bottom half the user can select whether the dirlist is to be sent to the printer or be saved as a text file. ═══ 13.6. Rename ═══ Rename The rename dialog is used for renaming files. The current filename is displayed in the depressed box and the user can enter the new name in the editbox below. The dialog will produce an error if illegal characters are used in the filename. ═══ 13.7. Describe ═══ Describe The describe dialog is used for describing files. The filename is displayed in the depressed box and the user can enter the file description in the editbox below. The description can no be longer that 40 characters and will be saved in the standard 4dos/4os2 description file format. ═══ 13.8. Relabel ═══ Relabel The relabel dialog is used for relabeling the current disk. The current volume label is displayed in the depressed box and the user can enter the new label in the editbox below. Note: This function is not case preserving. ═══ 13.9. Search ═══ Search The search dialog enables the user to set up the search criteria. Search for: You can search for a file matching either wildcards, text inside the file or both. You enter the wildcards and text in the editboxes to the right of the appropriate checkbox. The two radiobuttons toggles between matching both and matching only one of the above search methods. Text search options: The case sensitive checkbox enables case sensitive searching, and the match whole word makes the search routine look for you text string seperated either by space, tab or carriage return from the rest of the text. Note: These two functions have no effect if you are searching for a file matching a wildcard. ═══ 14. Registration ═══ Registration Select one of the following chapters: Why register? How to register ═══ 14.1. Why register? ═══ Why bother registering? Well. I've tried to put down many good reasons to do just that below. Read on, read on! ■ First of all, registering removes the irritating "beg" dialog that pops up when you start DirMaster, and also the one after configuration. ■ DirMaster will no longer display "Unregistered" in the title bar. Instead The statusline will include the name of the person the copy is registered to. For example: DirMaster 2.12r Registered to Alexander Wilkens ■ The about dialog will display your name as well as your serial number and the site you registered DirMaster from. ■ It does not cost that much! $39.50 (270NOK) is considerably less than any comercial product (like Norton Commander) costs. There are no hidden costs such as postage or anything. (except if you want DirMaster on a diskette) ■ The author has put down a LOT of work on DirMaster. The author has used much of his sparetime (I still attend school) programming. He deserves SOMETHING, doesn't he? ■ The more people who register, the more encouraged I will be to continue improving and developing DirMaster. ■ DirMaster can not be considered "crippleware" in ANY way, since all the functions are availible for you to evaluate. Even though I have do this, it does not mean that I am giving away DirMaster for free. If very few of the people using DirMaster registers it, then I may be foreced to add more beg dialogs, delays and other cruel things. I don't want to do that, and I don't think you, as a user, would like that much either. I suppose that speaks for itself.. Thank you for considering to register! ═══ 14.2. How to register ═══ How to register To see how you can register DirMaster ($39.50/270NOK) take a look in Register.Doc included in the DirMaster archive. This can be done from the help menu in DirMaster.